home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / util / libs / MultiReq.lha / MultiReq / Anleitung / MultiReq.dok < prev    next >
Text File  |  1992-11-12  |  12KB  |  247 lines
  1. ###############################################################################
  2. ##                                                                           ##
  3. ##      M     M            ll     tt     ii    RRRRR                         ##
  4. ##      MM   MM            ll     tt           RR  RR                        ##
  5. ##      MMM MMM   uu  uu   ll    ttttt   ii    RR  RR    eeee     qqqqq      ##
  6. ##      MMMMMMM   uu  uu   ll     tt     ii    RRRRR    ee  ee   qq  qq      ##
  7. ##      MM M MM   uu  uu   ll     tt     ii    RR RR    eeeeee   qq  qq      ##
  8. ##      MM   MM   uu  uu   ll     tt     ii    RR  RR   ee        qqqqq      ##
  9. ##      MM   MM    uuuuu    ll     ttt    ii   RR  RR    eeee        qq      ##
  10. ##                                                                   qq      ##
  11. ##                                                                           ##
  12. ###############################################################################
  13.  
  14.  
  15. MultiReq v1.20 © 11/1992 by Andreas Krebs (veröffentlicht am 12-Nov-92)
  16.  
  17.  
  18. Diese Datei enthält eine ausführliche Beschreibung des "Multitasking
  19. FileRequester", der über die FileRequester-Funktion der "multireq.library"
  20. gestartet wird. Die einzelnen Funktionen sind in der Datei Library.dok
  21. beschrieben.
  22.  
  23. 1. Einführung:
  24. ~~~~~~~~~~~~~~
  25. Die multireq.library und somit der FileRequester wurde komplett in Assembler
  26. geschrieben und ist somit relativ klein, bietet aber gleichzeitig ein Maximum an
  27. Bedienungskomfort und Schnelligkeit.
  28. Der Hauptunterschied zwischen dem "Multitasking FileRequester" und anderen
  29. FileRequestern besteht darin, daß er aus 2 Tasks besteht (deshalb Multitasking),
  30. nämlich einmal dem Task, der den FileRequester gestartet hat, und aus dem sog.
  31. "ReadProcess". Die Aufgaben des FileRequesters sind zwischen den 2 Tasks
  32. verteilt, wobei genau geregelt ist, wer was macht.
  33. Der Haupttask ist für die graphische Darstellung des FileRequesters und für alle
  34. Eingaben des Benutzers zuständig. Im Gegensatz dazu ist der ReadProcess nur für
  35. das Einlesen von Verzeichnissen zuständig und wird vom Haupttask gesteuert.
  36.  
  37. Diese Aufteilung erlaubt, daß auch während des Einlesens mit dem FileRequester
  38. weitergearbeitet werden kann, und bis auf 3 Gadgets stehen während des Einlesens
  39. alle Funktionen des FileRequesters zur Verfügung.
  40.  
  41.  
  42.  
  43. 2. Bedienung des FileRequesters:
  44. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  45. Nach dem Start öffnet der FileRequester ein Fenster, das folgende Listen und
  46. Gadgets enthält:
  47.  
  48. 2.1 Das Close-Gadget:
  49. ---------------------
  50. Dieses Gadget befindet sich in der linken oberen Ecke des FileRequesters und
  51. dient dazu, um den FileRequester zu verlassen, wobei nicht festgelegt ist, was
  52. passiert, wenn der FileRequester auf diese Art beendet wird. Dieses hängt immer
  53. von dem aufrufenden Programm ab.
  54.  
  55. 2.2 Das Move-Gadget:
  56. --------------------
  57. Dieses Gadget ist die Titelzeile der FileRequesters und erlaubt es den
  58. FileRequester zu verschieben.
  59.  
  60. 2.3 Das Depth-Gadget:
  61. ---------------------
  62. Dieses Gadget befindet sich in der rechten oberen Ecke und dient dazu, um den
  63. FileRequester in den Vorder- bzw. Hintergrund zu gelegt, je nachdem wo er sich
  64. gerade befindet.
  65.  
  66. 2.4 Die Files-Liste:
  67. --------------------
  68. Diese Liste befindet sich in dem großen Rechteck des FileRequesters und enthält
  69. alphabetisch geordnet alle gerade eingelesenen Unterverzeichnisse und Dateien
  70. des aktuellen Verzeichnisses, wobei zuerst die Verzeichnisse, versehen mit einem
  71. Schubladensymbol, angezeigt werden und anschließened alle Files, sowie ihre
  72. Größe. Während des Einlesevorgangs wird diese Reihenfolge der Darstellung nicht
  73. eingehalten, aber wenn er beendet ist, wird sie automatisch wiederhergestellt.
  74.  
  75. Wenn Sie ein Verzeichnis anklicken wird dieses automatisch zum aktuellen
  76. Verzeichnis (siehe 2.16) und anschließend wird dieses Verzeichnis eingelesen.
  77.  
  78. Wenn Sie eine Datei anklicken wird diese aktiviert (sie wird invertiert
  79. dargestellt) und ihr Name erscheint im File-Gadget (siehe 2.18). Eine eventuell
  80. zuvor aktivierte Datei wird inaktiviert.
  81. Ein Doppelklick auf eine Datei bewirkt zusätzlich noch, daß der FileRequester
  82. anschließend beendet wird.
  83.  
  84. 2.5 Die FileScroll-Gadgets:
  85. ---------------------------
  86. Diese 3 Gadgets befinden sich direkt hinter der Files-Liste und dienen dazu, um
  87. die File-Liste zu scrollen, wobei die 2 Pfeil-Gadgets dazu dienen, um in die
  88. Richtung des entsprechenden Pfeils zu scrollen.
  89. Das Proportional-Gadget (zwischen den 2 Pfeilen) erlaubt es durch bewegen des
  90. Balkens die FileList zu scrollen.
  91.  
  92. 2.6 Die Laufwerks-Liste:
  93. ------------------------
  94. Diese Liste befindet sich in dem Rechteck rechts von der Files-Liste und enthält
  95. alphabetisch geordnet alle angeschlossenen Laufwerke, eingelegten Disketten und
  96. logischen Geräte die gerade aktiv sind, wobei die Liste neu dargestellt wird,
  97. wenn eine Diskette eingelegt oder entnommen wird.
  98. Eine Ausnahme stellt der erste Eintrag mit Namen "Current" dar, er steht für das
  99. gerade aktuelle Verzeichnis des aufrufenden Tasks (nicht zu verwechslen mit dem
  100. des FileRequesters).
  101. Nach dem Eintrag "Current" folgt eine Liste aller angeschlossen Laufwerke, wobei
  102. je nach Art des Laufwerks entweder ein Disketten-, Festplatten oder IC-Symbol
  103. vor dem Namen dargestellt wird. Nach den Laufwerken werden die eingelegten
  104. Disketten, versehen mit dem Symbol VOL (für Volume), aufgelistet und dannach
  105. die logischen Geräte, versehen mit dem Symbol LDV (für Logical DeVice).
  106.  
  107. Wenn Sie einen der Einträge anklicken wird das zugehörige Verzeichnis zum
  108. aktuellen Verzeichnis und der Einlesevorgang wird gestartet.
  109.  
  110. 2.7 Die LaufwerksScroll-Gadgets:
  111. --------------------------------
  112. Diese 3 Gadgets befinden sich direkt hinter der Laufswerk-Liste und dienen dazu,
  113. um die Laufswerk-Liste zu scrollen. Diese Gadgets sind genauso aufgebaut wie die
  114. FileScroll-Gadgets (siehe 2.5).
  115.  
  116. 2.8 Das Directory-Gadget:
  117. -------------------------
  118. Dieses Gadget enthält den Text "Directory" gefolgt von "1" oder "2". Die Nummer
  119. steht für die Gerade angezeigte Files-Liste. Mit diesem Gadget können Sie
  120. zwischen den zwei Files-Listen umschalten, wenn Sie etwa öfters zwischen zwei
  121. Verzeichnissen wechseln müssen.
  122. Diese Funktion steht nicht zur Verfügung während ein Verzeichnis eingelesen
  123. wird, das Gadget wird solange ausgeschaltet und mit Punkten übermalt.
  124.  
  125. 2.9 Die Copy-Gadgets:
  126. ---------------------
  127. Diese zwei Gadgets enthalten den Text "Dir1->Dir2" bzw. "Dir2->Dir1" und
  128. erlauben es, denn Inhalt der Files-Liste 1 in die Liste 2 zukopieren bzw.
  129. umgekehrt. Durch dieses umkopieren ist es nicht nötig ein Verzeichnis zweimal
  130. einzulesen, wenn man es in beiden Files-Listen benötigt.
  131. Diese Funktion steht nicht zur Verfügung während ein Verzeichnis eingelesen
  132. wird, die Gadgets werden solange ausgeschaltet und mit Punkten übermalt.
  133.  
  134. 2.10 Das Show-Gadget:
  135. --------------------
  136. Dieses Stringgadget enthält ein Muster mit dem ausgewählt werden kann welche
  137. Dateien angezeigt werden soll, wobei nur solche Dateien angezeigt werden, die
  138. dem Muster entsprechen.
  139. Innerhalb des Musters steht das Zeichen '*' für einen beliebig langen Teilstring
  140. und '|' wird benutzt um zwei Muster zu trennen.
  141. So bewirkt ein Muster vom Typ "*.c|*-*|a*" z.B., daß alle Dateien angezeigt
  142. werden, die die Endung ".c" haben, ein "-"-Zeichen enthalten oder mit "a"
  143. beginnen, wobei nicht zwischen Groß- und Kleinschreibung unterschieden wird.
  144.  
  145. 2.11 Das Hide-Gadget:
  146. ---------------------
  147. Dieses Stringgadget enthält ein Muster mit dem ausgewählt werden kann welche
  148. Dateien nicht angezeigt werden soll, wobei nur solche Dateien nicht angezeigt
  149. werden, die dem Muster entsprechen.
  150. Das Muster ist genauso aufgebaut wie das des Show-Gadgets.
  151. Wenn eine Datei sowohl dem Show- als auch dem Hide-Muster entspricht, wird sie
  152. nicht angezeigt, da das Hide-Muster Priorität gegenüber dem Show-Muster hat.
  153.  
  154. 2.12 Das Info-Gadget:
  155. ---------------------
  156. Dieses Gadget enthält den Text "Show .info" oder "Hide .info" je nachdem, ob die
  157. Iconsdatein (also alle Dateien, die mit ".info" enden) angezeigt werden sollen
  158. oder nicht. Durch Anklicken dieses Gadgets wird der jeweilige Zustand verändert.
  159.  
  160. 2.13 Das Scan-Gadget:
  161. ---------------------
  162. Wenn Sie dieses Gadget anklicken wird entweder das aktuelle Verzeichnis weiter-
  163. eingelesen (wenn der Einlesevorgang unterbrochen war) oder das Verzeichnis wird
  164. komplett neu eingelesen (wenn es breits ganz eingelesen war).
  165.  
  166. 2.14 Das Stop-Gadget:
  167. ---------------------
  168. Dieses Gadget ist nur dann Sinnvoll, wenn gerade ein Verzeichnis eingelesen
  169. wird, denn dann ermöglicht es dieses Gadget, das der Einlesevorgang unterbrochen
  170. wird. Der Einlesevorgang kann jedoch jederzeit fortgesetzt werden, indem Sie
  171. einfach das Scan-Gadget anklicken.
  172.  
  173. 2.15 Die Reading-Anzeige:
  174. -------------------------
  175. Diese Anzeige ist das kleine Rechteck vor dem Text "Drawer:". Wenn diese Anzeige
  176. "leuchtet" (sie wird invertiert dargestellt), wird gerade ein Verzeichnis
  177. eingelesen.
  178.  
  179. 2.16 Das Drawer-Gadget:
  180. -----------------------
  181. Dieses Stringgadget enthält den Vollständigen Namen und Pfad des gerade
  182. aktuellen Verzeichnisses. In dieses Gadget können Sie auch von Hand den Namen
  183. und Pfad eines Verzeichnisses eingeben, und sobald Sie die RETURN-Taste drücken
  184. wird das Verzeichniss automatisch zum aktuellen Verzeichnis und somit wird auch
  185. der Einlesevorgang gestartet.
  186.  
  187. 2.17 Das '/'-Gadget:
  188. --------------------
  189. Wenn Sie dieses Gadget anklicken, wird das nächst höhere (parent) Verzeichnis
  190. des Gerade aktuellen Verzeichnisses aktiviert und eingelesen. Wenn kein höheres
  191. Verzeichnis existiert (z.B. beim Hauptverzeichnis von Disketten), passiert
  192. überhaupt nichts wenn Sie dieses Gadget anklicken.
  193.  
  194. 2.18 Das File-Gadget:
  195. ---------------------
  196. Dieses Stringgadget enthält den Namen der angeklickten Datei (diese wird in der
  197. Files-Liste invertiert dargestellt) oder den Namen einer Datei, die erzeugt
  198. werden soll. Im Gegensatz zum Drawer-Gadget verändert sich dieses Gadget jedoch
  199. nicht wenn Sie zwischen den 2 File-Listen umschalten.
  200. Dieses Gadget wird automatisch gesetzt, wenn Sie eine Datei anklicken. Sie
  201. können einen Dateinamen aber auch direkt in dieses Stringgadget eintragen, wobei
  202. der FileRequester beendet wird sobald Sie innerhalb dieses Gadgets <RETURN>
  203. drücken.
  204.  
  205. 2.19 Das Okay-Gadget:
  206. ---------------------
  207. Dieses Gadget befindet sich in der linken unteren Ecke des FileRequesters und
  208. kann verschiedene Texte enthalten. Wenn Sie dieses Gadget anklicken wird der
  209. FileRequester sofort beendet, wobei die daruch ausgelöste Funktion immer vom
  210. aufrufenden Programm abhängt.
  211.  
  212. 2.20 Das Message-Feld:
  213. ----------------------
  214. Dieses Feld befindet sich rechts neben dem Okay-Gadget und dient dazu, um
  215. Meldungen bzw. Informationen auszugeben. Normalerweise enthält dieses Feld einen
  216. Text der Art "x Files (y shown), z Dirs", der angibt was in der File-Liste
  217. dargestellt wird, wobei x für die Anzahl der eingelesenen Dateien steht, y
  218. angibt wieviele davon angezeigt werden und z für die Anzahl der Verzeichnisse
  219. steht.
  220. Falls jedoch ein Fehler aufgetretten ist wird hier ein Fehler ausgeben. Durch
  221. anklicken dieses Feldes verschwindet die Fehlermeldung wieder und es erscheint
  222. die sonst übliche Anzeige.
  223.  
  224. 2.21 Das Cancel-Gadget:
  225. -----------------------
  226. Mit diesem Gadget wird normalerweise der FileRequester abgebrochen, wobei die
  227. ausgelöste Funktion jedoch immer von dem aufrufenden Programm abhängt.
  228.  
  229.  
  230. Somit wäre der ganze FileRequester erklärt und die Bedienung dürfte Ihnen keine
  231. Probleme mehr auftauchen. Sollten Sie jedoch trotzdem noch Probleme, Anregungen,
  232. Verbesserungsvorschläge oder der gleichen haben, dann schicken Sie diese bitte
  233. an mich:
  234.  
  235. Andreas Krebs
  236. Mittelweg 9
  237. 7110 Öhringen 2
  238. Germany
  239.  
  240. Tel.: 07948/2101  (am Wochenende und in den Semesterferien)
  241.       0721/821356 (sonst)
  242.  
  243. Oder per Email einfach an folgende Adresse.
  244.  
  245. Email: s_krebs@iravcl.ira.uka.de
  246.  
  247.